home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / compuserve-file-archive / 07 CP_M / MYZ80.ZIP / MYZ80.DOC < prev    next >
Encoding:
Text File  |  1992-10-16  |  5.3 KB  |  139 lines
  1.  
  2.  
  3.  
  4.              MicroFast Z80 Emulation Engine code,
  5.                          MYZ80 API,
  6.      and The MYZ80 Emulator Package Versions 1.xx are each:
  7.               Copyright 1991,1992 Simeon Cran.
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                             M Y Z 8 0
  14.                             =========
  15.  
  16.                          by Simeon Cran.
  17.  
  18. Welcome to MYZ80!
  19. ~~~~~~~~~~~~~~~~~
  20. MYZ80 is a Z80/64180 emulator package. It was written to allow you 
  21. to finally get rid of those old Z80 computers which have done so 
  22. many fine years of service. The new 80386 machines with the fast 
  23. hard drives and the snazzy OS/2 operating systems are such a 
  24. delight... but for many, the Z80 machines still have to be fired 
  25. up from to time in order to develop code for CP/M and the Z80 
  26. chip. Well, not any more, thanks to MYZ80.
  27.  
  28. Other emulators on the market are less than satisfactory 
  29. solutions. Of the small number which can actually run without 
  30. causing system errors under the later versions of DOS, apparently 
  31. none are capable of running real CP/M. Instead they use an 
  32. emulated version of CP/M which is only as accurate as the 
  33. developers have bothered to make it.
  34.  
  35. None can run CP/M 3.0, and none can run ZCPR (which is such a 
  36. useful Z80 developer's environment). Add to that their less than 
  37. perfect Z80 emulation and slow overall performance, and until 
  38. MYZ80, the 'real' Z80 machines were destined to remain in the 
  39. office.
  40.  
  41. MYZ80 provides the solution being conceived, born and nurtured to 
  42. the point where it is now the most useful Z80 emulator package 
  43. ever!
  44.  
  45.  
  46. MYZ80 features.
  47. ~~~~~~~~~~~~~~~
  48. MYZ80 emulates the instruction set of the 8080, Z80 and Z180/64180 
  49. CPU chips. It does this with the "MicroFast Z80 Emulation Engine" 
  50. which is a very highly tuned piece of code designed to be as fast 
  51. and as accurate as technically possible on 80286, 80386 and 80486 
  52. CPUs.
  53.  
  54. MYZ80 provides an interface (the MYZ80 API) to the host computer 
  55. which allows real Z80 BDOSes to run in the MYZ80 environment. This 
  56. interface provides disk and character I/O as well as two banks of 
  57. 64k RAM (with common area) and a large RAM disk. These unique 
  58. features allow MYZ80 to run 'real' CP/M 2.2, CP/M 3.0, Z-System 
  59. and ZPM3.
  60.  
  61. MYZ80 is designed for the latest multitasking operating systems 
  62. and makes Z80 programs 'host friendly'. MYZ80 will share time very 
  63. fairly with the host. Even multiple instances of MYZ80 are 
  64. supported.
  65.  
  66. MYZ80 can take advantage of the latest computer hardware for 
  67. increased performance. The Microfast Z80 Emulation Engine operates 
  68. in either 16 (80286) or 32 (80386/80486) bit mode depending on the 
  69. capabilities of the host computer.
  70.  
  71. MYZ80 runs beautifully on IBM AT compatible (or better) computers 
  72. under DOS 3.3 compatible (or later) operating systems. This 
  73. includes running under OS/2 2.0, Desqview, and Windows 3.x.
  74.  
  75.  
  76. Starting MYZ80.
  77. ~~~~~~~~~~~~~~~
  78. MYZ80 is started from the DOS command line by simply typing the 
  79. name of its executable (CPM). However, advanced users may wish to 
  80. include optional arguments on the command line.
  81.  
  82. The first argument is the name of a boot file to be used instead 
  83. of the default (BOOT.CPM), and following arguments are saved by 
  84. MYZ80 and may be retrieved from within the MYZ80 environment.
  85.  
  86. MYZ80 always looks for its support files in the directory it 
  87. resides in. Therefore, you may start MYZ80 from any directory or 
  88. disk, and it will always find its support files (as long as they 
  89. are in the same directory as CPM.EXE).
  90.  
  91. MYZ80 may be run from a floppy disk (although a hard disk is 
  92. recommended). To do so, put CPM.EXE and the support files onto the 
  93. floppy disk, and start the program.
  94.  
  95.  
  96. Leaving MYZ80.
  97. ~~~~~~~~~~~~~~
  98. There are two ways to exit from the MYZ80 environment. You may 
  99. select the 'Abort and exit' choice from the pause box menu, or you 
  100. may run the MYZ80 utility QUIT.COM. The latter method also allows 
  101. you to specify an error level to return to DOS with (for use in 
  102. batch files).
  103.  
  104.  
  105. Further information.
  106. ~~~~~~~~~~~~~~~~~~~~
  107. Some explanations of the terms used above and further information 
  108. will be displayed to you when you start MYZ80 for the first time. 
  109. Legal information is provided in the file READ.1ST which was 
  110. supplied with this package. All the MYZ80 utilities have online 
  111. help. Other support files for MYZ80 should be provided in the 
  112. future and will probably be available from the place where you 
  113. found this package.
  114.  
  115.  
  116. The version of MYZ80 that you have now may not be perfect, but it 
  117. is pretty close! It has been released so that as many people as 
  118. possible can join the MYZ80 revolution, and keep CP/M and Z80 
  119. alive for years to come. Please enjoy it.
  120.  
  121.  
  122.  
  123. Simeon Cran.
  124.  
  125.  
  126.  
  127.  
  128.      *************************************************************
  129.      Acknowledgments:
  130.      Due to all the great help,  I feel  compelled to  acknowledge 
  131.      the support given by a number of people in the "Z" community. 
  132.      Especially Bruce Dudley (Sysop of Z-Node 62 in Perth, Western 
  133.      Australia), and the handful of crash testers in Australia and 
  134.      around  the  world.  And  to  all  those  people   who  truly 
  135.      appreciate  the  elegance  of   the  art   of  machine   code 
  136.      optimization, please enjoy "MYZ80 by Simeon Cran."
  137.      *************************************************************
  138.  
  139.